package com.mazaiting.manager.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.mazaiting.common.core.domain.result.Option;
import com.mazaiting.common.core.ex.exceptions.BusinessException;
import com.mazaiting.common.core.ex.exceptions.EmptyObjectException;
import com.mazaiting.manager.domain.entity.SysDept;
import com.mazaiting.manager.domain.form.DeptForm;
import com.mazaiting.manager.domain.query.DeptQuery;
import com.mazaiting.manager.domain.vo.dept.DeptDetailVO;
import com.mazaiting.manager.domain.vo.dept.DeptVO;

import java.util.List;

/**
 * <p>
 * 部门表 服务类
 * </p>
 *
 * @author mazaiting
 * @since 2022-09-20
 */
public interface ISysDeptService extends IService<SysDept> {

    /**
     * 部门列表
     * @param queryParams 查询参数
     * @return 部门列表
     */
    List<DeptVO> list(DeptQuery queryParams);

    /**
     * 部门树形下拉选项
     * @return 部门树形下拉选项
     */
    List<Option<Long>> listDeptOptions();

    /**
     * 新增部门
     * @param formData 表单数据
     * @return true: 新增成功; false: 新增失败
     */
    boolean save(DeptForm formData) throws BusinessException;

    /**
     * 根据部门 ID 获取部门详情
     * @param deptId 部门 ID
     * @return 部门详情
     */
    DeptDetailVO getDeptDetail(Long deptId) throws EmptyObjectException;

    /**
     * 修改部门
     * @param formData 表单数据
     * @return true: 更新成功; false: 更新失败
     */
    boolean update(DeptForm formData) throws EmptyObjectException;

    /**
     * 删除部门
     * @param ids 部门ID，多个以英文逗号(,)分割
     * @return true: 删除成功; false: 删除失败
     */
    boolean deleteByIds(String ids);
}
